home *** CD-ROM | disk | FTP | other *** search
/ Dr. Windows 3 / dr win3.zip / dr win3 / COMMUNIC / PROQWK1.ZIP / PROQWK.TXT next >
Text File  |  1993-10-04  |  21KB  |  405 lines
  1. ProQWK.txt
  2.  
  3. LEGAL STUFF:
  4.  
  5. This is the text file that accompanies the ProQWK Utilities,
  6. (c) 1993 by Socratic Software.
  7.  
  8. "ProComm Plus for Windows", "Windows ASPECT" and "Action Bar" are
  9. trademarks (c) 1992 Datastorm Technologies, Inc.
  10.  
  11. "Windows" is a trademark of Microsoft Corporation.
  12.  
  13. The script "ProQWK.wax" was compiled using the Windows ASPECT compiler,
  14. but was NOT written by Datastorm Technologies or any of its employees.
  15.  
  16. Socratic Software is not affiliated with Datastorm Technologies in any
  17. way.
  18.  
  19. DISCLAIMER:
  20.  
  21. Socratic Software does not make any guarantees, implicit or explicit,
  22. regarding the script "ProQWK.wax", and is not responsible for anything
  23. that may occur as a result of using it.  Users of this script are
  24. expected to exercise discretion and accept responsibility for such
  25. use, and any effects arising thereof.  So there.
  26.  
  27. ABOUT ProQWK:
  28.  
  29. What does this script do?
  30.  
  31.     ProQWK is a little utility meant for ProComm Plus for Windows users.
  32. We think it satisfies a need that many PC+/Win users have -- that is, to
  33. rename QWK packets in such a manner that the user can keep many QWK packets
  34. from the same source in their download directory at one time.  The utility
  35. renames QWK packets so that when a download of a new QWK packet takes
  36. place, the file transfer doesn't crash.  As well, ProQWK checks for the
  37. existence of a file with the extension "QWK", and if it doesn't find it,
  38. it won't rename.  Thus, users don't have to try and remember whether they
  39. renamed their QWK files before.
  40.     When a user chooses to rename a series of QWK files, ProQWK will
  41. delete the highest-numbered file that it is configured to keep for the BBS
  42. in question.  For example, a user may have ProQWK configured to keep seven
  43. extra QWK packets for a BBS called, oh, let's say "redeye" for example.
  44. If the QWK file name for the BBS is "redeye", ProQWK will look for a file
  45. named "redeye.qw6" (because the user chose seven extra packets for that
  46. series, and ProQWK starts numbering QWK files at zero, eg., "redeye.qwO"),
  47. and upon finding it, will delete it.  Next, it will change the name of the
  48. file "redeye.qw5" (if found) to "redeye.qw6"; "redeye.qw4" to "redeye.qw5";
  49. "redeye.qw3" to "redeye.qw4", and so on, until it does the last renaming,
  50. "redeye.qwk" to "redeye.qw0".  If there was no "redeye.qwk" in the down-
  51. load subdirectory, ProQWK will not go through this renaming procedure,
  52. because it would be unnecessary.  Please note that each time ProQWK renames
  53. & cycles "QWK" files (actually "QW?" files) in this manner, one file will
  54. be deleted and each remaining "QW?" file will be bumped up one rung on
  55. the "ladder".
  56.     ProQWK also is designed to help out with another problem sometimes
  57. encountered when using QWK offline readers -- when uploading a reply packet,
  58. a user will sometimes forget whether they have already uploaded it --
  59. ProQWK alleviates this problem by allowing users to upload, and then
  60. delete the "REP" packet in one "motion".  They can also choose to  upload
  61. only, or to delete only, REP packets that they wish to upload or delete.
  62.  
  63. Why bother?
  64.  
  65.     The main reason to use these utilities is to protect your QWK
  66. packets from premature deletion.  Some users may only keep one copy of a
  67. QWK packet for a particular BBS, read it, delete it, and then download
  68. a new one.  ProQWK is not going to be of much use to them.  But if you
  69. want to keep a packet from yesterday, and from a couple of days before
  70. that (etc.), for example, you may find ProQWK useful.  You can always go
  71. a packet or two (or up to ten) back & find those messages that you read
  72. a few days ago.  If you don't keep multiple copies of QWK packets, once
  73. you delete that QWK packet, it's gone, unless you have some kind of deleted
  74. file recovery utility.  We like to think that ProQWK is a more elegant
  75. alternative.
  76.  
  77. But doesn't Zmodem automatically rename files?
  78.  
  79.     In many communications software programs, zmodem downloads are
  80. automatically renamed when a file with the same name is already present in
  81. the download subdirectory.  The standard zmodem protocol, used by ProComm
  82. Plus for Windows, does not perform that function.  ProQWK is meant to at
  83. least enable users to work around this, if they desire to keep multiple
  84. copies of QWK files on their disk.  It doesn't *run* automatically, since
  85. users have to start it, and tell it which files to rename, but it is easier
  86. (and more convenient, if it is assigned to a "Meta Key") than using a file
  87. management utility to madly rename/delete/move files before the new file
  88. begins downloading.
  89.  
  90. How do I use it?
  91.  
  92.     Before downloading a fresh "qwk" packet for a BBS, simply choose
  93. the "QWK" option from the main menu and select the name of the BBS whose
  94. "qwk" packet you are about to download (ProQWK must be first set up to rename
  95. the files for that BBS.  See section below regarding setup.).  ProQWK will
  96. then rename the "QW?" files associated with that BBS, provided the setup
  97. was run properly.  As well, you can delete individual QW? files using
  98. ProQWK, rather than switching to a file management utility.
  99.  
  100. DO NOT ATTEMPT TO RENAME "QWK" PACKETS DURING A DOWNLOAD, OR WHEN A DOWNLOAD
  101. IS IMMINENT!  THIS MAY/WILL RUIN YOUR DOWNLOAD! (You may rename "QWK" files
  102. for BBS "A" while downloading a "QWK" file for BBS "B", but not for "A" while
  103. downloading "A")
  104.  
  105.     We suggest assigning a Meta Key to the "ProQWK.wax" script, in
  106. order to have ProQWK available at the touch of a button.  See your ProComm
  107. Plus for Windows user manual, or online help for more information on
  108. setting up Meta Keys to run scripts.
  109.  
  110. FILES NEEDED:
  111.  
  112. In order to use ProQWK Utilities, you need to have the archive,
  113. "PROQWK1.ZIP", which includes:
  114.  
  115.     ProQWK.txt    this file
  116.     ProQWK.wax    the Windows ASPECT executible file
  117.     socsof1.nil    the icon library for ProQWK Utilities &
  118.                 Socratic software
  119.  
  120. Installation & Setup:
  121.  
  122.     Uncompress the file "PROQWK1.ZIP" using PKZIP or other program
  123. that can uncompress "ZIP" files.
  124.  
  125.     The only files that need to be in any specific subdirectory are
  126. "ProQWK.wax", which should be copied to the subdirectory in which ProComm
  127. Plus for Windows expects to find your Windows ASPECT scripts; and
  128. "socsof1.nil", which should be copied to the subdirectory in which the
  129. executable "PW.EXE" (for ProComm Plus for Windows) is located (for
  130. example "c:\prowin").
  131.  
  132.     Once these two files have been placed in the proper subdirectories,
  133. the script can be run by selecting "Script...Run..." from the ProComm
  134. Plus for Windows pull-down menus, and choosing "ProQWK.wax" from the list
  135. that appears, or by selecting the "Script File" combobox button (the
  136. button with the underlined arrow pointing down) on the ProComm Plus for
  137. Windows "Action Bar", and selecting "ProQWK.wax" from the list that
  138. appears.  If you have not used ProQWK before (or if you have and your 
  139. "ProQWK.ini" file has been moved, erased, or renamed), it will ask you if 
  140. you wish to go through the setup routine.  If you wish to do so, select 
  141. "Setup", and you will be taken directly to the setup routine.  If you 
  142. choose "Cancel," the script will stop running and you will either have to 
  143. find your "ProQWK.ini" file and place it in your Windows subdirectory, or 
  144. run ProQWK again and choose to go through the setup routine.
  145.  
  146.     ProQWK Utilities will create a new file on your hard drive called
  147. "ProQWK.ini" (I know what you're thinking: "Ugh! Not ANOTHER 'ini' file!"
  148. But, it's not that bad! :) See "De-installing ProQWK" below.), which will
  149. be placed in your Windows subdirectory.  This file is necessary for ProQWK
  150. to read various setup information in order to be able to execute.  Whenever
  151. you make a change in your configuration, ProQWK will update the "ProQWK.ini"
  152. file.
  153.  
  154. Setup Options:
  155.  
  156. When you are faced with the ProQWK setup dialog box, you will need
  157. to enter the path to your "download" subdirectory, which is where you
  158. keep your downloaded QWK files, for example "c:\prowin\dnload". If you
  159. don't enter the proper path, ProQWK will not be able to rename/delete
  160. any of your QWK type files, and will be at least 50% useless.  The same
  161. follows for your "upload" su